<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt-br" lang="pt-br">
<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<title>Assistente de Texto : Guia do Usuário CodeIgniter</title>

<style type='text/css' media='all'>@import url('../userguide.css');</style>
<link rel='stylesheet' type='text/css' media='all' href='../userguide.css' />

<script type="text/javascript" src="../nav/nav.js"></script>
<script type="text/javascript" src="../nav/prototype.lite.js"></script>
<script type="text/javascript" src="../nav/moo.fx.js"></script>
<script type="text/javascript" src="../nav/user_guide_menu.js"></script>

<meta http-equiv="expires" content="-1" />
<meta http-equiv="pragma" content="no-cache" />
<meta name="robots" content="all" />
<meta name="author" content="ExpressionEngine Dev Team" />
<meta name="description" content="Guia do Usuário do CodeIgniter" />

</head>
<body>

<!-- START NAVIGATION -->
<div id="nav"><div id="nav_inner"><script type="text/javascript">create_menu('../');</script></div></div>
<div id="nav2"><a name="top"></a><a href="javascript:void(0);" onclick="myHeight.toggle();"><img src="../images/nav_toggle_darker.jpg" width="154" height="43" border="0" title="Alternar Tabela de Conteúdos" alt="Alternar Tabela de Conteúdos" /></a></div>
<div id="masthead">
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td><h1>Guia de Usuário CodeIgniter Versão 2.0.0</h1></td>
<td id="breadcrumb_right"><a href="../toc.html">Tabela de Conteúdos</a></td>
</tr>
</table>
</div>
<!-- END NAVIGATION -->


<!-- START BREADCRUMB -->
<table cellpadding="0" cellspacing="0" border="0" style="width:100%">
<tr>
<td id="breadcrumb">
<a href="http://codeigniter.com.br/">Página Inicial</a> › 
<a href="../index.html">Guia de Usuário CodeIgniter</a> › Assistente de Texto
</td>
<td id="searchbox"><form method="get" action="http://www.google.com.br/search"><input type="hidden" name="as_sitesearch" id="as_sitesearch" value="codeigniter.com.br/manual/" />Busca <input type="text" class="input" style="width:200px;" name="q" id="q" size="31" maxlength="255" value="" /> <input type="submit" class="submit" name="sa" value="Ok" /></form></td>
</tr>
</table>
<!-- END BREADCRUMB -->

<br clear="all" />


<!-- START CONTENT -->
<div id="content">


<h1>Assistente de Texto</h1>

<p>O arquivo Assistente de Texto contém funções que auxiliam no trabalho com texto.</p>


<h2>Carregando este Assistente</h2>

<p>Este assistente é carregado usando o seguinte código:</p>
<code>$this->load->helper('text');</code>

<p>As funções disponíveis são as seguintes:</p>


<h2>word_limiter()</h2>

<p>Trunca uma string para o número de <strong>palavras</strong> especificado. Exemplo</p>

<code>
$string = "Aqui temos um belo texto de oito palavras.";<br />
<br />
$string = word_limiter($string, 4);<br /><br />

// Retorna: Aqui temos um belo&#8230;
</code>

<p>O terceiro parâmetro é um sufixo opcional adicionado à string. Por padrão adiciona-se reticências.</p>


<h2>character_limiter()</h2>

<p>Trunca uma string para o número de <strong>caracteres</strong> especificado. Mantem a integridade 
das palavras de modo que a contagem pode ter uma pequena variação para mais ou para menos do que você especificar. Exemplo:</p>

<code>
$string = "Aqui temos um belo texto de oito palavras.";<br />
<br />
$string = character_limiter($string, 20);<br /><br />

// Retorna:  Aqui temos um belo&#8230;
</code>

<p>O terceiro parâmetro é um sufixo opcional adicionado à string. Por padrão adiciona-se reticências.</p>



<h2>ascii_to_entities()</h2>

<p>Converte valores ASCII em character entities, incluindo high ASCII e caracteres MS Word que podem causar problemas quando usado em uma página da web,
de modo que possam ser mostrados sem erros não obstante configurações do browser ou serem armazenados sem problemas em uma base de dados.
Existe algumas dependências no seu conjunto de caracteres suportados pelo servidor, portanto isto pode não ser 100% confiável, mas na maioria
dos casos ele identificará corretamente os caracteres fora do escopo normal (acentuados por exemplo). Exemplo:</p>

<code>$string = ascii_to_entities($string);</code>


<h2>entities_to_ascii()</h2>

<p>Esta função faz o oposto da anterior, transforma character entities de volta em ASCII.</p>

<h2>convert_accented_characters()</h2>

<p>Caracteres high ASCII translitera para baixa ASCII equivalentes, útil quando os caracteres não-Inglês precisam ser usados ​​onde somente caracteres ASCII padrão são utilizados com segurança, por exemplo, em URLs.</p>

<code>$string = convert_accented_characters($string);</code>

<p>Esta função usa um arquivo de configuração junto <dfn>application/config/foreign_chars.php</dfn> para definir o que for de array para a transliteração.</p>

<h2>word_censor()</h2>

<p>Habilita a censura de palavras de uma determinada string. O primeiro parâmetro conterá a string original. O
segundo conterá uma array de palavras proibidas. O terceiro (opcional) conterá um valor substituto
para as palavras. Se não especificado elas serão subsituidas por sinal de "jogo da velha": ####. Exemplo:</p>

<code>
$proibidas = array('tóxico', 'maconha', 'cocaina', 'cigarro');<br />
<br />
$string = word_censor($string, $proibidas, 'Gandalf!');</code>


<h2>highlight_code()</h2>

<p>Colore uma string de código(PHP, HTML, etc.). Exemplo:</p>

<code>$string = highlight_code($string);</code>

<p>A função usa a função highlight_string() do PHP, as cores usadas são as especificadas no seu arquivo php.ini.</p>


<h2>highlight_phrase()</h2>

<p>Destacará uma frase dentro de uma string de texto. O primeiro parâmetro conterá a string original, o segundo
conterá a frase que deseja destacar. Os terceiro e quarto parâmetros conterão as tags HTML de abertura e fechamento
onde a frase estará contida. Exemplo:</p>

<code>
$string = "Aqui está um belo texto sobre nada em especial.";<br />
<br />
$string = highlight_phrase($string, "belo texto", '&lt;span style="color:#990000">', '&lt;/span>');
</code>

<p>O código acima retornará:</p>

<p>Aqui está um <span style="color:#990000">belo texto</span> sobre nada em especial.</p>



<h2>word_wrap()</h2>

<p>Quebra a linha de texto conforme o número de <strong>caracteres</strong> especificados mantendo as palavras inteiras. Exemplo:</p>

<code>$string = "Aqui temos um string simples de texto que nos ajudará a demonstrar esta função.";<br />
<br />
echo word_wrap($string, 25);<br />
<br />
// Produzirá:<br />
<br />
Aqui temos um string simples<br />
de texto que nos ajudará<br />
a demonstrar esta função</code>

<h2>ellipsize()</h2>

<p>Esta função retira as tags de uma string, dividindo em um comprimento máximo definido, e insere uma reticências.</p>
<p>O primeiro parâmetro é a string a eliptizar, o segundo é o número de caracteres na string final. O terceiro parâmetro é o lugar onde na string as reticências devem aparecer com valor de 0 - 1, da esquerda para a direita. Por exemplo. um valor de 1 vai colocar reticências à direita da cadeia, .5 no meio, e 0 na esquerda.</p>
<p>Um quarto parâmetro opcional é o tipo de reticências. Por padrão, <samp>&amp;hellip;</samp> será inserido.</p>

<code>$str = 'essa_sequencia_eh_inteiramente_demasiado_longo_e_pode_quebrar_meu_projeto.jpg';<br />
<br />
echo ellipsize($str, 32, .5);</code>

Produzirá:

<code>essa_string_eh_i&hellip;_meu_projeto.jpg</code>


</div>
<!-- END CONTENT -->


<div id="footer">
<p>
Tópico Anterior:&nbsp;&nbsp;<a href="string_helper.html">Assistente de String</a>
&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="#top">Topo da Página</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
<a href="../index.html">Guia de Usuário CodeIgniter</a>&nbsp;&nbsp;&nbsp;&middot;&nbsp;&nbsp;
Próximo Assunto:&nbsp;&nbsp;<a href="typography_helper.html">Assistente de Tipografia</a>
</p>
<p><a href="http://codeigniter.com.br">CodeIgniter</a> &nbsp;&middot;&nbsp; Copyright &#169; 2006 - 2011 &nbsp;&middot;&nbsp; <a href="http://ellislab.com/">EllisLab, Inc.</a></p>
</div>

</body>
</html>